

    \filetitle{dat2str}{Convert IRIS dates to cell array of strings}{dates/dat2str}

	\paragraph{Syntax}\label{syntax}

\begin{verbatim}
S = dat2str(Dat,...)
\end{verbatim}

\paragraph{Input arguments}\label{input-arguments}

\begin{itemize}
\itemsep1pt\parskip0pt\parsep0pt
\item
  \texttt{Dat} {[} numeric {]} - IRIS serial date number(s).
\end{itemize}

\paragraph{Output arguments}\label{output-arguments}

\begin{itemize}
\itemsep1pt\parskip0pt\parsep0pt
\item
  \texttt{S} {[} cellstr {]} - Cellstr with strings representing the
  input dates.
\end{itemize}

\paragraph{Options}\label{options}

\begin{itemize}
\item
  \texttt{'dateFormat='} {[} char \textbar{} cellstr \textbar{}
  \emph{`YYYYFP'} {]} - Date format string, or array of format strings
  (possibly different for each date).
\item
  \texttt{'freqLetters='} {[} char \textbar{} \emph{`YHQBM'} {]} -
  Letters representing the five possible frequencies
  (annual,semi-annual,quarterly,bimontly,monthly).
\item
  \texttt{'months='} {[} cellstr \textbar{} \emph{English names of
  months} {]} - Cell array of twelve strings representing the names of
  months.
\item
  \texttt{'standinMonth='} {[} numeric \textbar{} `last' \textbar{}
  \emph{1} {]} - Which month will represent a
  lower-than-monthly-frequency date if month is part of the date format
  string.
\end{itemize}

\paragraph{Description}\label{description}

The date format string can include any combination of the following
fields:

\begin{itemize}
\item
  \texttt{'Y'} - Year.
\item
  \texttt{'YYYY'} - Four-digit year.
\item
  \texttt{'YY'} - Two-digit year.
\item
  \texttt{'P'} - Period within the year (half-year, quarter, bi-month,
  month).
\item
  \texttt{'PP'} - Two-digit period within the year.
\item
  \texttt{'R'} - Upper-case roman numeral for the period within the
  year.
\item
  \texttt{'r'} - Lower-case roman numeral for the period within the
  year.
\item
  \texttt{'M'} - Month numeral.
\item
  \texttt{'MM'} - Two-digit month numeral.
\item
  \texttt{'MMMM'}, \texttt{'Mmmm'}, \texttt{'mmmm'} - Case-sensitive
  name of month.
\item
  \texttt{'MMM'}, \texttt{'Mmm'}, \texttt{'mmm'} - Case-sensitive
  three-letter abbreviation of month.
\item
  \texttt{'F'} - Upper-case letter representing the date frequency.
\item
  \texttt{'f'} - Lower-case letter representing the date frequency.
\item
  \texttt{'EE'} - Two-digit end-of-month day; stand-in month used for
  non-monthly dates.
\item
  \texttt{'E'} - End-of-month day; stand-in month used for non-monthly
  dates.
\item
  \texttt{'WW'} - Two-digit end-of-month workday; stand-in month used
  for non-monthly dates.
\item
  \texttt{'W'} - End-of-month workday; stand-in month used for
  non-monthly dates.
\item
  \texttt{'DD'} - Two-digit day numeral; daily dates only.
\item
  \texttt{'D'} - Day numeral; daily dates only.
\end{itemize}

To get some of the above letters printed literally in the date string,
use a percent sign as an escape character, i.e. `\%Y', etc.

\paragraph{Example}\label{example}


